Skip to content

docs: check KVM the way the Linux service uses it - #67

Closed
biswaroop1547 wants to merge 2 commits into
mainfrom
fix/linux-kvm-check
Closed

biswaroop1547 wants to merge 2 commits into
mainfrom
fix/linux-kvm-check

Conversation

@biswaroop1547

@biswaroop1547 biswaroop1547 commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

The Linux KVM check could print KVM access is ready when the daemon can't use KVM. test -r and test -w only check file modes, and they run with the login's groups. The daemon runs under the user's systemd manager, which keeps its old groups after usermod -aG kvm while another session or lingering keeps it alive. The new command opens /dev/kvm in a one-shot systemd-run --user unit, the way the service does, so it also works without a user D-Bus. The text now says a group change needs a restart.

Case Old check New check
Group added while an older session or lingering keeps the user manager running (Raspberry Pi 5) KVM access is ready Not ready
/dev/kvm node with no KVM behind it (x86 VM) KVM access is ready Not ready
Working KVM, manager has the group, with or without a user D-Bus KVM access is ready KVM access is ready
No /dev/kvm Not ready Not ready, and no file is created, even as root

Setup and doctor run the same check after premAI-io/premapp-backend#1172.

Limits: checked in Ubuntu 24.04 containers on the Pi and an x86 VM, not on Debian 13. I ran cspell on the page locally; the site build runs in CI.

🤖 Generated with Claude Code

biswaroop1547 and others added 2 commits November 6, 2026 13:55
The old check tested file modes, so it printed 'KVM access is ready' for a
device node without a working KVM driver, and for a login that has the kvm
group while the user's service manager still has the old groups. Open the
device through the user's systemd manager instead, and say that a group
change needs a restart when another session or lingering keeps services
running.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
systemd-run --wait/--pipe needs the user D-Bus, so the check said
"not ready" on a working host without one. A one-shot unit reaches the
user manager without it, like the daemon's own setup check.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@biswaroop1547

Copy link
Copy Markdown
Contributor Author

Folded into #69.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant